home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / dhhelper.zip / DEMO0.HLS < prev    next >
Text File  |  1990-06-22  |  5KB  |  123 lines

  1. !========================================================================
  2. !
  3. ! DEMO0.hls     A simple demonstration Help file for use with The Helper.
  4. ! Lines which start with ! in column 1 are commands. If they are not
  5. ! recognised as commands they are treated as comments (like these lines).
  6. !
  7. ! To compile and run this demonstration from The Helper, type
  8. ! Alt-R (type R while holding down the Alt key).
  9. !
  10. !========================================================================
  11. !
  12. !   All the information needed to create Help files can be found
  13. !   by pressing the F1 key for help. For starting off though, here
  14. !   are a few tips and pointers:
  15. !
  16. !   Structure of the Help files
  17. !   ----------------------------
  18. !   Help files are organised into Categories which must be numbered
  19. !   sequentially from 1. Each category has 1 or more pages.
  20. !   The "!category#" command (where ! is in column 1, and # is a number)
  21. !   defines the start of a new category and the first page of that
  22. !   category. Subsequent pages within each category are defined by the
  23. !   "!page2", "!page3", etc. commands.
  24. !
  25. !   Other commands starting with ! in column 1
  26. !   -------------------------------------------
  27. !   Other commands control things like window size, colors, the type of
  28. !   border around windows, conditional statements like "if...else...",
  29. !   including text from another disk file, overlays (for animating your
  30. !   Help files) and many more. Press F1 and select "Commands" from the
  31. !   main help menu to see them all.
  32. !
  33. !   Control character commands ^A, ^B, and ^C
  34. !   ------------------------------------------
  35. !   There are also three commands which can be imbedded into the text.
  36. !   ^A (pronounced "control A") is used to indicate where to place
  37. !   highlighted phrases in the file, and what to do when the Enter key
  38. !   is pressed on the highlighted phrase. ^B is used to change colors
  39. !   temporarily on the screen, and ^C is used for inserting a text
  40. !   memory which has been defined earlier with the "!define" command.
  41. !
  42. !   The commands are inserted into the text with the control characters
  43. !   ^A, ^B and ^C.  To enter a control character into the text type ^P
  44. !   first, then the control character.
  45. !   e.g. To enter ^A hold down the Ctrl key and type "P" and "A", then
  46. !        release the Ctrl key. You will see an "A" in the text, but it
  47. !        will be displayed as a highlight to indicate that it is a
  48. !        control character, like this.... 
  49. !
  50. !========================================================================
  51. !----- The source code for this demo starts here...
  52. !
  53. !Category1                     ----- Start the first category
  54. !Window  12 4 64 17            ----- Set window coordinates. Max=1 1 80 25.
  55. !Colors 79 79 78 48 7 7 15 112 ----- Specify default colors.....
  56. !                         4 for color screens, and 4 for mono screens:
  57. !                         Border, text, highlight, cursor (color+mono)
  58. !                         You can use 0 to leave some of them unchanged.
  59. !                         Select "Color Table" from F1-Help to see colors
  60. !
  61. !----- Now start the text for the first page...
  62.  
  63.    (47,112) ─────────────────────────────────────────── (0)
  64.    (47,112)            DEMO0   -   CONTENTS             (0)
  65.    (47,112) ─────────────────────────────────────────── (0)
  66.  
  67.    Use  and <Enter> to select a topic.
  68.    Type F1 from anywhere to return to this menu.
  69.    Type Esc at any stage to Quit.
  70.  
  71.      (4,0) Open another window and clear this one 
  72.        (2,0+)  Open another window over this one 
  73. !
  74. !----- Note the use of ^A to mark highlighted phrases in some of the lines...
  75. !----- ^A(2,1) means go to category 2, page1.
  76. !----- ^A(2,0) goes to the page last displayed in category 2.
  77. !----- ^A(2,0+) is the same as ^A(2,0) except that the current screen will
  78. !----- not be cleared - screen(2,0) is overlayed onto the current screen.
  79. !----- Also note the use of ^B to temporarily change color.
  80. !----- ^B(47,112) sets color 47 if a color screen is being used, or 112 for
  81. !----- mono screens.  ^B(0) returns the color to the default value.
  82. !-----  will be printed as arrows. Type F8 to enter these and other
  83. !----- extended characters into the text.
  84. !Category2
  85. !Window 51 12 80 22
  86. !Colors 47 47 0 94 112 112 7 15
  87. !Border1     ----- Specify single border
  88.  
  89.  The calling screen remains
  90.  displayed because of the +
  91.  sign in the command
  92.  
  93.  ^A(2,0+) ... ^A
  94.  
  95.  (3,0+) Like this:  Press Enter 
  96. !Category3
  97. !Window 29 7 54 19
  98. !Colors 30 30 0 0 0 0 0 0
  99.  
  100.   The calling screen
  101.   remains displayed
  102.   because of the +
  103.   sign in the command
  104.  
  105.   ^A(3,0+) ... ^A
  106.  
  107.   Type (128)F1(0) to return...
  108. !-----
  109. !----- Note the use of ^B(128) to start blinking, and ^B(0) to stop.
  110. !Category4
  111. !Window 4 5 75 12
  112. !Colors 96 96 0 0 0 0 0 0
  113. !Border2        ----- Specify double border
  114.  
  115.  Page 1.  The calling screen is cleared, as there is no + sign in the
  116.           command ^A(4,0) ... ^A
  117.  
  118.     Press (111,15)Backspace(0) or (111,15)F1(0) to return, or (111,15)PgDn(0) for page 2...
  119. !page2
  120. !Window 4 10 75 14
  121.  
  122.  Page 2.  Backspace or (128)F1(0) to return, or PgUp to return to page 1...
  123.